Installing the Nodinite IBM MQ Monitoring Agent
Unlock seamless, secure monitoring for your IBM MQ environment with the Nodinite IBM MQ Monitoring Agent. This guide empowers you to:
- ✅ Rapidly install and configure the agent for instant visibility into queues, topics, channels, and listeners
- ✅ Ensure compliance and security with robust Windows Service and account management
- ✅ Minimize downtime with clear troubleshooting and support resources
- ✅ Accelerate business continuity with automated post-install guidance
Follow these steps to install the Nodinite IBM MQ Monitoring Agent and start monitoring your IBM MQ infrastructure with confidence.
Note
You must be a local administrator to install Windows Services.
Before you begin
Make sure you meet all prerequisites for IBM MQ Monitoring Agent before proceeding.
Step 1: Start the installer
From the server where you want to install the IBM MQ Monitoring Agent, use RDP and double-click the MSI file to launch the installation.
The MSI installer for IBM MQ Monitoring Agent.
Step 2: Welcome Screen
When the MSI file runs, you'll see the Welcome screen.
Welcome screen for the IBM MQ Monitoring Agent installer.
Click 'Next' to continue or 'Cancel' to exit the installer.
Step 3: Custom Setup
Select features and the installation location. Default settings are recommended for most users.
Custom setup options for the IBM MQ Monitoring Agent.
Click 'Next' to proceed or 'Cancel' to exit.
Step 4: Service Account Information
Enter credentials for the Account that will run the IBM MQ Monitoring Agent as a Windows Service. You will set specific user rights per queue manager later during Configuration.
- Account (Domain\User)
- Domain: Enter the domain name or use the server name/dot (.) for a local account
- User: Enter the account name
- Password: Enter the password for the account.
Service account credentials for the IBM MQ Monitoring Agent.
Note
The account must have 'Log on as Service Right'. Review Prerequisites for details.
Click 'Next' to continue or 'Cancel' to exit.
Step 5: Ready to install
Ready to install the IBM MQ Monitoring Agent.
Files in use
If the Monitoring Agent is already installed and you are performing an Update, you may see a dialog about files in use. Select 'Close the applications and attempt to restart them' and click 'Ok'.
Depending on current load and threads in use, the operation may take anywhere from 0-30 seconds to complete
Dialog shown when updating an existing Monitoring Agent installation.
Insufficient Privileges
If the account information does not meet the Prerequisites for the IBM MQ Monitoring Agent, you will see an error message.
Error message for insufficient privileges during installation.
The most common reasons are that the account is not allowed to run as a service or is not a local Administrator. Follow the How to set Logon as a Service right guide and click retry. If the problem persists, click cancel and restart. Make sure to enter valid credentials!
Tip
Check the local event log for errors (both System and Application).
Step 6: Completed setup
The final step shows either a success or a premature exit.
Successful installation example
Successful installation of the IBM MQ Monitoring Agent.
Failed installation example: A failed installation will result in a premature exit.
Premature exit due to failed installation.
Click Finish to exit the installer.
When setup completes successfully, your default text editor will open a file named 'README.txt'. This file contains additional information needed to add the agent as a Monitoring Agent. The file is [re]generated on each successful start.
README.txt file with post-installation instructions.
To add the IBM MQ Monitoring Agent as a Monitoring Agent, follow the shared article below:
Support
If you encounter installation issues, contact our Support team for expert guidance.
Note
Additional troubleshooting information may be available in the Windows Event Logs.
Frequently asked questions
Find solutions to common problems and FAQs for the Nodinite IBM MQ Monitoring Agent in the Troubleshooting user guide.
Next Step
Add or manage a Monitoring Agent Configuration
Configuration
Uninstall
Update